<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>

<head>

<title>Getting Started - phoneME Feature Software (MR4)</title>
    <link rel="stylesheet" href="./style/document.css" type="text/css">

<!--
<style type="text/css"> /* <![CDATA[ */
@import "/branding/css/tigris.css";
@import "/branding/css/inst.css";
/* ]]> */</style>
<link rel="stylesheet" type="text/css" href="/branding/css/print.css" media="print" />
<script src="/branding/scripts/tigris.js" type="text/javascript"></script>

<script src="/branding/scripts/alm.js" type="text/javascript"></script>
<style type="text/css">
/* <![CDATA[ */
@import "/brinding/css/alm.css";
/* ]]> */
</style>
-->

<!--
<title>Getting Started - phoneME Feature Software (MR4)</title>
<link rel="stylesheet" href="./style/tigris.css" type="text/css">
<link rel="stylesheet" href="./style/inst.css" type="text/css">

<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<meta http-equiv="Content-Style-Type" content="text/css" />
<meta name="version" content="4.5.2.148.4" />

<style type="text/css"></style>
-->

</head>

<body  class="composite">
<div class="strut">&nbsp;</div>
</td>
<td id="midcol">
<div id="bodycol">

<!--  ===============    BEGIN PAGE BODY (Ignore Everything Above)  ============= -->

<!-- Header -->
<table class="full-width">
  <tr>
    <td align="center" class=sun-darkblue>
      <h1>Getting Started</h1>
      <h2>phoneME&#153; Feature Software (MR4)</h2>
      <h4>April 2009</h4>
    </td>
  </tr>
  <tr>
    <td class=sun-lightblue>&nbsp;</td>
  </tr>
</table>
<p>
<!-- End Header -->

<!-- BEGIN PAGE TITLE -->
<a name="software"></a>
<div id="projecthome" class="app"> <h2><font color="#225577">Downloading phoneME
Feature Software Source Code<span class="style1"></span></font></h2>
<!-- END PAGE TITLE -->

<p>
<a href="../index.html">home</a> | <a href="./index_feature.html">first-prev</a> | 
<a href="./begin_feature.html">next</a> | <a href="./client_feature.html">last</a> 
<p>
The phoneME Feature software project provides two ways for you to access the source 
code:
<p>
<ul>
<li>Download the required phoneME Feature software <a href="#zip_file">zip archive</a> 
file and supporting software binary files.  These include:
<ul>
<li>The phoneME Feature download source file, 
<code>phoneme_feature-mr4-rel-src-</code><i>buildnum</i>-<i>date</i><code>.zip</>
<li>The supporting <a href="#zip_files">Qsound</a> multimedia libraries binary 
file, <code>qsound.zip</code>
<li>The supporting <a href="#zip_files">emulator binary file</a>,
<code>phoneme_feature_-mr4-rel-emulator-</code><i>buildnum</i><code>-win-</code><i>date</i><code>.zip</code>
</ul>
<li>Check out the phoneME Feature source code from the Subversion 
<a href="#repo">repository</a>.
</ul>
<!--
<p>
<b>Note:</b> The emulator binary plugin provides emulation functionality based on the LIME protocol,
a stream protocol used for communicating between native code and Java ME. It allows synchronous
method invocations and event notifications between a native client and a virtual machine, using 
shared memory for maximum throughput. For more information on the LIME protocol, see 
-->
<p>
Taken together, the phoneME Feature source files, plus the emulator and Qsound binary 
plugins, provide everything needed to build the phoneME Feature software.
<p>
<b>Note:</b> To build JSR 239, you also need an OpenGL ES engine. For instructions 
on how to build JSR 239, see the engine documentation and 
<a href="http://java.sun.com/javame/reference/docs/sjwc-2.2/pdf-html/html/build/index.html">
<i>Sun Java Wireless Client Software Build Guide</i></a>.
<p>
To check out the source code from the Subversion repository you must 
have a <a href="http://subversion.tigris.org/project_packages.html">
Subversion client</a> installed on your platform. For more information on using 
Subversion, see the phoneME Feature 
<a href="https://phoneme.dev.java.net/servlets/ProjectSource">Access</a> page.
<p>
For more information on the structure of the phoneME Feature source code repository and 
how to work with it, see the 
<a href="http://wiki.java.net/bin/view/Mobileandembedded/PhoneMERepositoryStructure">
phoneME Repository Structure</a> page.
<p>


<!-- BEGIN SECTION HEAD -->
<hr noshade="noshade" size="1">
<a name="zip_file"></a><h3>Downloading the Source Code Zip Archive File</h3>
<!-- END SECTION HEAD -->
<p>
To download the source code zip file, take the following steps:
<p>
<ol>
<b><li>Create a top-level directory on your platform in which to unzip the phoneME Feature
source zip file. Name this directory whatever you choose. For example:</b>
<p>
<code>C:\> mkdir mr4</code>
<p>
<b><li>Go to the phoneME Feature 
<a href="https://phoneme.dev.java.net/downloads_page.html">
Downloads page</a> and click the MR4 zip file name to copy it to your platform.</b>
<p>
<b><li>Once the file is downloaded, unzip the file into the directory you have 
assigned as your top-level source directory.</b>
<p>
<code>C:\> unzip 
phoneme_feature-mr4-rel-src-</code><i>buildnum</i>-<i>date</i><code>.zip
-d C:\mr4</code>
<p>
<li><b>Once you have unpacked your phoneME Feature sources, assign your</b> 
<code><</code><i>top_level_source_dir</i><code>>/phoneme_feature</code> <b>directory 
to the variable</b> <code>%COMPONENTS_DIR%</code><b>, as shown in the following example.  For 
more information on setting variables, see </b><a href="./begin_feature.html#env"> Setting 
Variables for Your Build Environment</a>.
<p>
<code>C:\> set COMPONENTS_DIR=C:/mr4/phoneme_feature</code>
<p>
For more information on setting the <code>%COMPONENTS_DIR%</code> variable, see 
<a href="./buildenv_feature.html#table1-1">Table 1-1</a>.
</ol>
<p>


<!-- BEGIN SECTION HEAD -->
<hr noshade="noshade" size="1">
<a name="zip_files"></a><h3>Downloading the Qsound and Emulator Binary Files</h3>
<!-- END SECTION HEAD -->
<p>
Once you have created the <code>phoneme_feature</code> directory and installed the phoneME 
Feature source files, follow these steps to install the Qsound and emulator binary files:
<p>
<ol>
<b><li>Go to the phoneME Feature <a href="https://phoneme.dev.java.net/downloads_page.html">
downloads page</a> and click the Qsound zip file name to copy it to your platform.</b>
<p>
<b><li>Once the file is downloaded, unzip the file into the top-level directory you have 
created.</b>
<p>
<code>C:\> unzip qsound.zip -d C:\mr4</code>
<p>
<li><b>Make another top-level directory for the phoneME Feature emulator.  This directory
should be different than the top-level directory you created for the phoneME Feature 
source.  For example:</b>
<p>
<code>C:\> mkdir mr4_emulator</code>
<p>
<b><li>Go to the phoneME Feature
<a href="https://phoneme.dev.java.net/downloads_page.html"> downloads page</a> and 
click the emulator zip file name to copy it to your platform.</b>
<p>
<b><li>Once the emulator file is downloaded, unzip the file into the newly-created
emulator directory. For example:</b>
<p>
<code>C:\> unzip <code>phoneme_feature_-mr4-rel-emulator-</code><i>buildnum</i><code>-win-</code><i>date</i><code>.zip</code> -d C:\mr4_emulator</code>
<p>
<li><b>Once you have unpacked your emulator files, assign the</b>
<code><</code><i>top_level_emulator_dir</i><code>>/phoneme_feature</code> <b>directory 
to the variable</b> <code>%EMULATOR_DIR%</code><b>, as shown in the following example.</b>
<p>
<code>C:\> set EMULATOR_DIR=C:/mr4_emulator/phoneme_feature</code>
<p>
For more information on setting the <code>%EMULATOR_DIR%</code> variable, see
<a href="./client_feature.html#table5-1">Table 5-1</a>.
</ol>
<p>

 
<!-- BEGIN SECTION HEAD -->
<hr noshade="noshade" size="1">
<a name="repo"></a><h3>Checking Out the Source Code Repository</h3>
<!-- END SECTION HEAD  -->
<p>
To check out the phoneME Feature source code repository, you must first install 
a Subversion client on your platform.  Once the client is installed, take the 
following steps:
<p>
<ol>
<b><li>Create a top-level directory on your platform and change To it. For example: 
</b>
<p>
<code>C:\> mkdir mr4</code>
<p>
<b><li>In your top-level directory, create a sub-directory for your source. For example:</b> 
<p>
<code>C:\> mkdir phoneme_feature</code>
<p>
<li><b>Assign your top-level and sub-directory to the variable <code>%COMPONENTS_DIR%</code>.  
For example:</b>
<p>
<code>C:\> set COMPONENTS_DIR=C:/mr4/phoneme_feature</code>
<p>
<b>Note:</b> Checking out phoneME Feature code from the source repository is a 
different process than downloading and unzipping the phoneME Feature zip file. 
Therefore, the directory location you set for the <code>%COMPONENTS_DIR%</code> 
variable may differ for each operation.
<p>
<b><li>Change directory to</b> <code>%COMPONENTS_DIR%</CODE>
<p>
<code>C:\> cd mr4/phoneme_feature</code>
<p>
<b><li>Check out the source code using the following command:</b>
<p>
<code>% svn co 
https://phoneme.dev.java.net/svn/phoneme/components/</code><em>component_name</em><code>/trunk</code> 
<em>component_name</em>
<p>
<b>Note:</b> In the phoneME Feature URL command string, <em>component_name</em> is the 
name of the component you are working with. For example, if you are checking out the 
MIDP component, substitute <code>midp</code> for <em>component_name</em> in both places. 
<p>
<b><li>Go to the phoneME Feature <a href="https://phoneme.dev.java.net/downloads_page.html">
downloads page</a> and click the Qsound zip file name to copy it to your platform.</b>
<p>
<b><li>Unzip the Qsound file into your phoneME Feature source repository location. For example:</b>
<p>
<code>C:\> unzip qsound.zip -d C:\mr4</code>
<p>
<b><li>Follow steps 3-6 in the section</b> <a href="#zip_files">Downloading the Qsound and
Emulator Binary Files</a> <b>to install the emulator with your phoneME Feature source.</b>   
</ol>
<p>


<!-- BEGIN SECTION HEAD -->
<hr noshade="noshade" size="1">
<a name="docs"></a><h3>Updating the Source Code</h3>
<!-- END SECTION HEAD  -->
<p>
If you are working in the phoneME Feature software source code repository, you can 
periodically  update your code to get the latest checkins and improvements. Do the 
following:
<p>
<ol>
<b><li>Change to the directory for the component you want to update, for example, MIDP.</b>
<p>
<code>C:\> cd mr4/phoneme_feature/midp</code>
<p>
<b><li>Enter the update command to update the component, as shown here.</b>
<p>
<code>C:\> svn update</code>
<p>
</ol>
<p>
If you want to update other components, repeat the above steps for those components.
<pre>


</pre>

<a href="../index.html">home</a> | <a href="./index_feature.html">first-prev</a> | 
<a href="./begin_feature.html">next</a> | <a href="./client_feature.html">last</a> 
<p>

<!-- =============================== END PAGE BODY ================================= --> 

<p>
<hr noshade="noshade" size="1">

<p class="copyright"><a href="./style/copyright.html">Copyright</a>
&#169; 2009 Sun Microsystems, Inc. All rights reserved. 
</p>

</div></td></tr></tbody></table></body></html>
